home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 17 / CU Amiga Magazine's Super CD-ROM 17 (1997)(EMAP Images)(GB)[!][issue 1997-12].iso / CUCD / Programming / DiceSource / doc / UTILITIES.DOC < prev    next >
Text File  |  1994-02-13  |  4KB  |  120 lines
  1.  
  2. compiler/utilities                        compiler/utilities
  3. compiler/UTILITIES                        compiler/UTILITIES
  4.  
  5.                  DICE SYSTEM UTILITIES
  6.                   REGISTERED VERSION
  7.  
  8.     This is an overview of DICE utilities, please refer to individual
  9.     manual pages for more information
  10.  
  11.     <wildcard> support exists for many commands.  This is an unanchored
  12.     search and things like:     fubar/#?/#?  WILL WORK.
  13.  
  14.  
  15.     dobj objfile_or_library [-o outfile]
  16.  
  17.     DOBJ disassembles object files and libraries.  There are no limitations
  18.     to object or library file size.
  19.  
  20.     cat <wildcard>
  21.  
  22.     CAT types out one or more files as specified by the wildcard.  Startup
  23.     is a bit slower than TYPE due to the directory scan.
  24.  
  25.     expand <wildcard>
  26.     expand <fmt> <wildcard> ...
  27.  
  28.     EXPAND generates a list of files, one per line, using the specified
  29.     <fmt> string (default "%s").  This allows you to generate repetetive
  30.     command sequences on a large number of files efficiently.
  31.  
  32.     1> expand #?
  33.     1> expand "fubar %s" #?
  34.  
  35.     If you wish to specify more than one wildcard you MUST supply a
  36.     format.  For example:
  37.  
  38.     1> expand %s #?.c ram:#?
  39.  
  40.     libtos amiga.lib amigas.lib
  41.  
  42.     LIBTOS converts a large-data-model AMIGA.LIB into a small-data-model
  43.     AMIGAS.LIB ... source is included in the LIB directory allowing
  44.     modification to convert other libraries.
  45.  
  46.     A small-data model AMIGAS.LIB allows DICE to generate residentable
  47.     code.
  48.  
  49.     makeproto -o outfile file1 file2 ... fileN
  50.  
  51.     MAKEPROTO is a cute utility to create a prototype file given a set
  52.     of source files in a clean fashion, without relying on crazy compiler
  53.     options.
  54.  
  55.     The idea is to create a DEFS.H file that all your source files include
  56.     with all the stuff you normally stick in such a file plus the following
  57.     defines:
  58.  
  59.     #define Prototype   extern
  60.     #define Local        static  /*    or as nothing at all */
  61.  
  62.     Each file prototypes functions declared in that file, for example:
  63.  
  64.     Prototype int x;
  65.     Prototype void FuBar(int);
  66.  
  67.     int x;
  68.     /* etc...   */
  69.  
  70.  
  71.     You then create a PROTOS.H file by running MAKEPROTO on all source
  72.     files.    This file should be #include'd by DEFS.H .  MAKEPROTO simply
  73.     extracts all lines beginning with 'Prototype' into the specified
  74.     output file.
  75.  
  76.     dsearch "string" <wildcard>
  77.  
  78.     Searches for the specified string in the specified files.  Quite fast.
  79.     Search is case insensitive.
  80.  
  81.     head <wildcard>
  82.  
  83.     Prints the first 10 lines of each specified file.
  84.  
  85.     wc <wildcard>
  86.  
  87.     counts characters, words, and lines in each specified file and
  88.     prints a total at the very end.
  89.  
  90.     dupdate <files and options>
  91.  
  92.     used to create distributions, in general copies some source tree
  93.     to some destination tree, but only necessary files to bring the
  94.     destination up to par.    Has other features.
  95.  
  96.     autorefs outfile <wildcard>
  97.  
  98.     Used to generate DME.REFS files from .H files, AUTODOC files, and
  99.     other manual pages.
  100.  
  101.     'outfile' is always appended to so if you are re-generating a
  102.     refs file you should first delete it.  files in <wildcard> are
  103.     scanned, with .H recognized as header files and others as
  104.     document files.
  105.  
  106.     du path
  107.  
  108.     DU stands for DISK-USAGE, and reports the aproximate number of
  109.     blocks in a directory tree.  It tries to figure out the number
  110.     of blocks files actually take up by adding a fudge factor for
  111.     side sectors, and it's pretty close, but not perfect.
  112.  
  113.     dprof proffile
  114.  
  115.     DPROF is a program profiler.  When you compile a program with the
  116.     -prof option it will generate a binary data file on exit. The DPROF
  117.     program interprets this .dprof file and displays the profile in
  118.     formatted text.
  119.  
  120.